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5.0 MISCELLANEOUS PERIPHERALS 

'rhc Alto can have a number of slow peripherals which appear to programs as memory locations in the 
range 177000-177777n. The standard peripherals are described here. 

5.1 Keyboard 

The Alto keyboard contains 61 or 64 keys. It appears to the program as four 16 bit words in 4 adjacent 
locations starting at khdad (177034b). Depressed keys correspond to zeroes in memory, idle keys 
correspond to ones. Figure 6 shows layouts of the Microswitch and ADL keyboards, including keytops 
and the word number, bit number corresponding to each key. All Alto Is and the more recent Alto lis 
have Microswitch keyboards; earlier Alto lis have ADL keyboards, which are somewhat larger and have 
columns of fxmction keys on the left and right sides. 
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I'L stands for the function keys at the leR of the keyboard; FR for those at the right. 

Figure 6 
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Note: Connecting an Alto I keyboard to an Alto II or an Alto II Microswitch keyboard to an Alto I 
requires rewiring a connector or installing an adaptor cable. An ADL keyboard requires additional logic 
to connect to an Alto I. 

5.2 Mouse 

The mouse is a hand-held pointing device which contains two encoders which digitize its position as it is 
rolled over a table-top. It also has three buttons which may be read as the three low-order bits of 
memory location unuN (177030b), in the manner of the keyboard. 'Fhe bit/button correspondences in 
uniJN are (depressed keys correspond to O's in memory): 

unLiN[13] Top or Left Button (red) 

miLiN[14] Bottom or Right Button (blue) 

UTILIN[15] Middle Button (YELLOW) 

The mouse coordinates arc maintained by the mrt microcode in locations mouseloc(424b) = x and 
mouseloc+I(425b) = y in page one of the Alto memory. These coordinates are relative, i.e., the 
hardware only increments and decrements them. The resolution of the mouse is approximately 100 
points per inch. 

5 J Keyset 

The standard Alto includes a fivc-fmger keyset which is presented to the program as 5 bits of memory 
location U'l'iLiN (177030b), similar to the keyboard. The bit/key correspondences in uriLiN are 
(depressed keys correspond to O's in memory): 

UJILIN[8] Key (left-most) 

imLiN[9] Key 1 

UT1LIN[10] Key 2 

ijruJN[ll] Key 3 

unLiN[12] Key 4 (right-most) 

5.4 External Device Interface 

Iwo memory locations, ijriLiN (177030]0 and UTlLOur (177016b), provide an interface to external 
devices through a connector on the rear of the Alto. If a quantity is stored into UTll^oin; it is latched 
and appears as 16 output signals; if a 1 bit is stored, a more negative logic level is generated ('ITL "low"). 
Vov input, bits to 5 and bit 7 of utilin are available; more positive logic levels (rri, "high") are 
reported as I bits. The remaining bits of this location are used by the mouse, keyset and memory 
configuration switch. 

On the Alto 1, this connector also provides various power supply voltages. These arc absent on Alto II. 

The Alto II provides an additional 16-bit input port (the X bus), which can be read by accessing memory 
locations J77020B- 177023b. ^Ihc connector on the rear of the Alto II provides the low 2 bits of memory 
address and a signal that indicates the x bus is being read, together with the 16 input data signals. More 
positive logic levels (itl "high") are reported as 1 bits. 

The two sections below describe two common devices connected to UTlLlN/uril-OLrr, the Diablo HyTypc 
printer and Versatec printer/plotter, 'llic descriptions arc for the programmer: the bit values (O or 1) 
refer to values that will be stored into uruDur or read from utilin by an Alto program. 
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5A1 Diablo Printer 

'line Diablo Hylypc printer plugs into a connector on the rear of the Alto, and is controlled by 
referencing two locations in Alto memory. None of the timing signals required by the printer are 
generated automatically-all must be program generated. For detailed infonnation on the printer, refer to 
the Diablo manual. 

Location uriLiN (177030b): 

unLiN[0] Paper ready bit. when the printer is ready for a paper scrolling opcradon, 

uriLlNfl] Printer check bit. Should the printer find itself in an abnormal state, it sets this 

bit to 0. 

i7nLiN[2] Unused. 

utiijn[3] Daisy ready bit. when the printer is ready to print a character. 

um.iN[4] Carriage ready bit. when the printer is ready for horizontal positioning. 

U'rnjN[5] Ready bit. Both this bit and the appropriate other ready bit (carriage, daisy, 

etc.) must be before attempting any output operation, 

UTnJN[6] (Memory configuration switch -- see section 5.5) 

miLiN[7] Unused. 

Location UTiLOUr (177016b): 

Several of the output operations are invoked by "toggling" a bit in the 'output status word. To toggle a 
bit, set it first to 1, then back to O immediately. 

lJllLOU'r[0] Paper strobe bit. Toggling this bit causes a paper scrolling operation. 

unLOUT[l] Restore bit. Toggling this bit resets the printer (including clearing the "check" 

condition if present) and moves the carriage to the left margin. 

ljriL0Ui[2] Ribbon bit. When this bit is 1 the ribbon is up (in printing position); when 0, 

it is down. 

miL0U'r[3] Daisy strobe bit. Toggling this bit causes a character to be printed. 

i;nL0U'i'[4] Carriage strobe bit. Toggling this bit causes a horizontal positioning operation. 

U'rn.Our[5-15] Argument to various output operations: 

L Printing characters. When the daisy bit is toggled bits 9-15 of this field 
are interpreted as an ASCn character code to be printed (it should be 
noted that all codes less than 40b print as lower case "w"). 

2. For paper and carriage operations the field is interpreted as a displacement 
(-1024 to +1023), in units of 1/48 inch for paper and 1/60 inch for 
carriage. Positive is down or to the right, negative up or to the left. The 
value is represented as sign-magnitude (i.e., bit 5 is 1 for negative 
numbers, for positive; bits 6-15 are the absolute value of the number). 

I1ic printer is initialized by toggling the restore bit, then waiting for all ready bits to be 0. A typical 
output sequence, say printing a character, involves examining the check bit for abnormal status, waiting 
for both the ready and daisy ready bits to be 0, then writing in tlic printer output location the character 
code, the character code ORcd with the daisy strobe bit, and the unmodified code again. 

Hie device behaves more or less like a plotter, i.e. you must explicitly position each character in 
software; a print operation does not affect the position of either the carriage or the paper. All coordinates 
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in paper or carriage operations are relative; the device does not know its absolute position. Again, you 
must keep track of tliis in software. 

warning: On Alto I, the printer cable should not be changed (connected or disconnected) while Alto 
power is on. The printer power is derived from the Alto power supplies; changing the cable causes a 
large transient which usually crashes the processor and does bad things to the disk drive. On Alto II, tlic 
printer is independently powered and may therefore be connected or disconnected at any time. 

5.4.2 Versatec Plotters and Printer/Plotters 

Because of their delightfully simple hardware interface, all manner of Versatec equipment may be driven 
from the Alto with ease. The description below gives the signal assignments and a small number of 
coding tricks; the programmer should consult a Versatec manual for details (bulletin 6002, Matrix Basic 
Interface Description is particularly helpful), l^he notation * is used below to indicate a signal whose 
sense is inverted. 



Location U'l'iLlN (177030n): 



UJ'ILlNfl] 




ONLINE* 


U'niJN[2] 




NOPAP 


uniJNp] 




RlvADY* 


i UlILOUT 


(177016B): 


U'J1IOUT[0] 




RFFRD 


urn.ouT[l] 




CLEAR 


LniL0Ul[2] 




RLTER 


un 1. 0UT[3] 




PICLK* 


urn.our[4] 




PRINT* 


UriL0lJT[5] 




SPP 


urn.oui[6] 




RI'SET 


u*rn.our[7] 




Rl'OrR 


uriKOur[8-15] 


IN08* to INOl* 



On-line (inverted). 
No paper. 
Ready (inverted). 



Remote form feed. 

Clear print line. 

Remote line terminate. 

Print clock (inverted). 

Print select (inverted) - print =0, plot=l 

Simultaneous print/plot. 

Remote reset. 

Remote end of transmission. 

Data bits to be sent to the Versatec (inverted). Bit 8 is 

the most significant bit of the nibble; bit 15 is the least 

significant. 



None of the timing signals (picek) arc generated automatically by the Alto-tlie programmer must cause 
the signals to wave appropriately. The Alto II DIAGN0SE2 instruction is particulariy helpful for 
generating the clock signals. I^he control functions (rei*ed, clear, rlter, reset, reotr) are generated 
by raising and then lowering them: 



IDA FORMFEED 
IDA 1 FORMTOGGLE 
LDA 3 UFILOUTADR 
DIAGN0SE2 

FORMFEFD: 114000 ; RFFUD + PICLK* + PRINT* 
FORMTOGGLE: 100000 ; RFFED 
UTlIOmADR: 177016 



Data bytes must be sent with care, because the uriLOUT data lines take a little time to set up. The data 
is first set, then the clock bit is toggled, and then die clock bit is toggled again: 
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LDA DATA 

COM 

LDA 1 DATAMASK 

AND 1 

LDA 3 UTILOUTADR 

STA 3 

LDA 1 DATATOGGLE 

DIAGN0SE2 

DATA: 111 

DATAMASK: 014377 

DATATOGGLE: 010000 

UTILOUTADR: 177016 



Note that data must be inverted . 

Save IN0a*-IN01*,PICLK*, PRINT*. We're plotting 

Let data sett1e--clock is "off" 

Toggle clock "on" then "off" 

ASCII code for "I" 

PICLK* + PRINT* + data mask 

PICLK* 



On Alto I, DiAGNOsm is not available, but its effect may be emulated. 



5,5 Parity Error Detection 



The detection and reporting of parity errors is accomplished somewhat differently on Alto I and Alto II. 
In both machines, the processing of errors is undertaken by a high-priority microtask, which is invoked 
very soon after an error occurs. The microtask reports a parity error by causing an interrupt on emulator 
interrupt channel 15, i.e., by ORing a one into NWW[15]. Bear in mind that parity errors can.be generated 
by memory references undertaken by any microtask; as a result, it may be some time between the 
occurrence of the error and the next execution of the emulator task and consequent servicing of the 
interrupt. 

When a parity error happens, the parity task stores the contents of various R registers into some page 1 
reserved locations given below. Unfortunately, the information recorded by the parity task is not 
sufficient to determine precisely where the parity error occurred. The intent of the collection is to save 
values of the R registers most likely to be used as a source of memory addresses. 

Use 

Disk control block fetch pointer 
Disk word fetch/store pointer 
Display word fetch address 
Display control block fetch address 
Current program counter in the emulator 
Temporary register for indirection in emulator 

Alio 11 

1lic Alto II memory contains circuitry for correcting single-bit errors and detecting double-bit errors. 
The logic expects a good deal of set-up and in turn reports copious error information. Interaction with 
the error control is effected through three memory locations (177024b, 177025ii and 177026i0. Detailed 
information on the operation of the error correction mechanism is best obtained from the logic drawings. 

Memory Hrror Address Register (mi^ar - 177024n). This register is a 'shadow mar': it holds the 
addicss of the first error since the error status was last reset. If no error has occurred, mi^ar reports the 
address of the most recent memory access. Note that mear is set whenever an error of any kind (single- 
bit or double-bit) is detected. 

Memory Krror Status Register (Mt^SR = 177025b). This register reports specifics of the first error that 
occurred since ml:sr was last reset. Storing anything into this register resets the error logic and enables it 
to detect a new error. Bits are "low ti*ue," i.e. if the bit is 0, the condition is true. 



Address 


R-Register 


614b 


dcbr 


615b 


KNMAR 


616b 


DWA 


617b 


CIU 


620b 


PC 


621b 


SAD 
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mi{Sr[0-5] Hamming code reported from error 

m1^sr[6] Parity Error 

mI':sk[7] Memory parity bit 

mhsr[8-13] Syndrome bits 

mi:SK[14-15] liank number in which error occurred 

mi*:sr[14-15] is an extension to the most significant end of mfar. This field is only present if the 
extended memory option is installed (see section 2.3), otherwise it reads out -J. 

Memory Krror Control Register (MFrR = 177026H). Storing into this register is the means for 
controlling the memory error logic. This register is set to all ones (disable all interrupts) when the Alto 
is bootslrapi^ed and when the parity error task first detects an error. When an error has occurred, mhar 
and MitSR should be read before setting the mecr. Bits are "low true," i.e. a bit enables the condition. 

Mi:CR[0-3] Spare 

mi^cr[4-10] Test Hamming code (used only for special diagnostics) 

mecrIiI] Test mode (used only for special diagnostics) 

ivincR[12] Cause interrupt on single-bit errors if zero 

MI'Cr[13] Cause interrupt on double-bit crroi*s if zero 

iviI':cr[14] Do not use error correction if zero 

mhcr[15] Spare 

Note that Mi:CR[12] and [13] govern only the initiation of interrupts; MHAR and MESR hold information 
about the first error that occurs after rcseting MESR regardless of what kind of errors are to cause 
interrupts. 

ADDRESS MAPPING 

The mapping of addresses to memory chips can be altered by the setting of the "memory configuration 
switch." This switch is located on the front of Alto l\ and at the top of the backplane of the Alto II. 
llie current setting of the switch is reported in bit 6 of utiein (location 177030i0: if this bit is 0, the 
switch is in the "nonnaV position ("up" on Alto I, "back" on Alto II), otherwise the switch is in the 
"alternate" position. On Alto I, if the switch is in the alternate position, the first two 16K portions of 
memory arc exchanged (i.e., the memory address is modified by the algorithm: if mar[0] = then 
mar[1]<-mar[1] xor 1). On Alto 11, if the switch is in the alternate position, the first and second 32K 
portions of memory are exchanged (i.e., the memory address is modified by the algorithm: 
mar[O]<-mar[0] xor 1). 

In order to fix many memory problems, it is necessary to know the mapping between memory addresses 
(and bit numbers) to actual memory chips on the memory boards. Herewith the mapping, given in the 
style of a program: the algorithm is given the memory address (address) and the bit position in the word 
(bii). The function odd(x) returns true if the 16-bit number x is odd. The variable switch corresponds to 
the setting of the memory configuration switch (i.e., switch ^utilin[6]). 

Alio I 

The variables row and column are the "coordinates" of the memory chip on the given cardSloU as printed 
by the memory diagnostic, ^rhe chipNumber is tlie chip number on the memory board. IJit 16 is the 
parity bit. 

if addrcss[0]-0 then (if switch -1 then address[l]*-address[l] xor 1) 

row^address[2-4] 

cardSlot<-(address[0vl])*4 -+■ 13 

if odd(address) then card<-card4-2 

column <- bit 

if bit >^ 12 then [ card<-card-f 1; column<-bit-5 ] 
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chipNumber<- 15 + column + 14*row 



Alio II 



The Alto II memory system is organized around 32-bit doublewords. Stored along with each double 
word is 6 bits of hamming code and a parity bit for a total of 39 bits; 



bits 0-15 


even data word 


bits 16-31 


odd data word 


bits 32-37 


Hamming code 


bit 38 


parity bit 



Things are further complicated by the fact that two types of memory chips are used: 16K chips in 
machines with the extended memory option (see section 2.3), and 4K chips for all others. 

The bits in a 1-chip deep slice of memory are called a group. A group contains 4K or 16K double 
words, depending on chip type. The bits of a group on a single board are called a subgroup. Thus a 
subgroup contains 10 of the 40 bits in a group, lliere are 8 subgroups on a memory board. Subgroups 
are numbered from the high 3 bits of the address: for 4K chips this means mar[0-2]; for 16K chips (i.e. 
an Alto with extended memory) this means nANK.MAR[0]: 



Sub 


group 


chip positions 


7 




81-90 


6 




71-80 


5 




61-70 


4 




51-60 


3 




41-50 


2 




31-40 


1 




21-30 







11-20 



Nearest tlie edge connector 



The location of the bits in group is: 



CARD 1 CARD 2 CARD 3 CARD 4 

32 2A 16 08 00 | 33 2G 17 09 01 | 34 26 18 10 02 | 35 27 19 11 03 

36 28 20 12 04 | 37 29 21 13 05 | 38 30 22 14 06 | XX 31 23 15 07 

t t t t 

chip position 11 ™~~ "" 

Chips 15, 25, 35, 45, 55, 65, 75, and 85 on board 4 aren't used. If you are out of replacement memory 
chips, you can use one of these, but then the board witli the missing chips will only work in Slot 4. 

The algorithm for converting address and bil into cardSlot and chipNumber is (the variable 'xm' is tme if 
the Alto has extended memory): 

if odd(addrcss) then bit<-bit+16 
a\ if switch- 1 then addrcss[O]^address[0] xor 1 
cardSlot <- (bit mod 4) +1 

ChipNumber^ bit/8 + 16 - (if odd(bit/4) then 5 else 0) + 
10 * (if xm then address[0] else address[0-2]) -h 
(if xm then bank*20 else 0) 

A second entry to this algorithm is wiUi an address (usually read from mear), and a syndrome (usually 
read from MliSR, but remember that it must be complemented; syndrome <-(rv(Mi:sR))[8- 13] XOR llw)). 
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bit^syndroiTicMapping[syndromc] (see tabic below) 

if bit=-l then error ("impossible'* syndrome) 
enter the algorithm above at a. 

11ie syndromeMapping maps a 6-bit number (range to 63) into the number of the bad bit (0 to 38) 
or -1 if the syndrome is incorrect: 






38 


37 


36 




35 -] 


L 18 -1 


10 


34 


29 


14 




7 -] 


L 22 -1 


20 


33 


27 


12 




5 -] 


L 20 -1 


30 


2 


31 


16 




9 -] 


I 24 -1 


40 


32 


26 


11 




4 -] 


L 19 -1 


50 


1 


30 


15 




8 -] 


L 23 -1 


60 





28 


13 


-1 


6 -] 


L 21 -1 


70 


3 


-1 


17 


-1 


10 -] 


L 25 -1 



(syndrome values to 7) 
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6M DISK AND CONTROLLER 



l\\c disk controller is designed to accommodate one of a variety of diabi.0 disk drives, including models 
31 and 44. Each drive accommodates one or two disks. Each disk has two heads, one per side. 
Information is recorded on each disk in a 12-sector format on each of up to 406 (depending on the disk 
model) radial track positions. Thus, each disk contains up to 9744 recording positions (2 heads x 12 
sectors x 406 track positions). Figure 7 tabulates various useful information about the performance of the 
disk drives. 



DUVICK 

Number of drivcs/Allo 
Number of packs 

Number of cylinders 
'rracks/cylinder/pack 
Sectors per track 
Words per sector 



Data words/track 
Sectors/pack 

Rotation Umc 
Seek time (approx.) 

min-avg-niax 
Average access to 1 megabyte 

Transfer rate: 

peak/avg 
peak/avg 
per sector 
for full display 
for 64k memory 
whole drive 



DIABLO 31 

lor 2 

1 removable 



203 

2 

12 

2 header 

8 label 

256 data 

3072 

4872 

40 

15 + 8.6*sqrt(dt) 

15-70-135 

80 

1.6/1.22 

10.2/13 

3.3 

.460 

1.03 

19.3 



DIABIX) 44 




1 




1 removable 




1 fixed 




406 




2 




12 




2 header 




8 label 




256 data 




3072 




9744 




25 


ms 


8-h3*sqrt(dt) 


ms * 


8-30-68 


ms 


32 (using both, packs) 


ms 


2.5/1.9 


MIIz 


6.7/8. 


jLts/word 


2.1 


ms 


.266 


sec 


.6 


sec 


44(both packs) 


sec 



* I'hc notation dt stands for the number of tracks traveled during the seek. 

Figure 7 

The disk controller records three independent data blocks in each sector. I'he first is two words long, 
and is intended to include the addfcss of tlie sector. 1'his block is called the Header block. The second 
block is eight words long, and is called the Label block. The third block is 256 words long, and is the 
Data block. Each block may be independently read, written, or checked, except that writing, once begun, 
must continue until the end of the sector. 

When a block is checked, information on the disk is compared word for word with a specified block of 
main memory. During checking, a main memory word containing has special significance. When this 
word is encountered, the matching word read from the disk is stored in its place and docs not take part 
in the check. This feature permits a combination of reading and checking to occur in the same block. 
(It also has the drawback of making it impossible to use the disk controller to check for words containing 
on the disk.) 



The Alto program communicates with the disk controller via a four-word block of main memory 
beginning at location KBLK (52Ih). The first word is interpreted as a pointer to a chain of disk command 
blocks. If it contains 0, the disk controller will remain idle. Otherwise, the disk controller will 
commence cxectition of the command contained in the first disk command block. When a command is 
completed successftilly, the disk controller stores in krlk a pointer to the next command in the chain 
and the cycle repeats. If a command terminates in error, a is immediately stored in khi,k and the disk 
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controller idles. At the l:)eginning of each sector, status information, including the number of the current 
sector, is stored in kblkh-1. This can be used by the Alto program to sense the readiness of the disk 
and to schedule disk transfers, for example. When the disk controller begins executing a command, it 
stores the disk address of that command in KBLK + 2. This infoiTnation is later used by the disk 
controller to decide wlicther seek operations or disk switches are necessary. It can be used by the Alto 
program for scheduling disk arm motion. If the Alto program stores an illegal disk address (like -1) in 
this word, the disk controller will perform a seek at the beginning of the next disk operation. (This is 
useful, for example, when a disk driver wants to force a restore operation.) The disk controller also 
communicates with the Alto program by interrupts (see Section 3.2). At the beginning of each sector 
interrupts are initiated on the channels specified by the bits in KBLK + 3. 

KiiLK (52110: Pointer to first disk command block. 

KULK + 1 (522b): Status at beginning of current sector. 

KBLKH-2 (523b): Disk address of most-recently started disk command. 

KBLK + 3 (524b): Sector interrupt bit mask. 

A disk command block is a ten-word block of memory which describes a disk transfer operation to the 
disk controller, and which is also used by the controller to record the status of that operation. The first 
word is a pointer to the next disk command block in this chain. A means that this is the last disk 
command block in tlic chain. When the command is complete, the disk controller stores its status in the 
second word. The third word contains the command itself, telling the disk controller what to do. I'he 
fourth word contains a pointer to the block of memory from/to which the header block will be 
transferred. The fifth word contains a similar pointer for the label block. The sixth word contains a 
similar pointer for the data block. 

1'he seventh and eiglith words of the disk command block control the initiation of interrupts when the 
command block is finished. If the command terminates without error, interrupts are initiated on the 
channels specified by the bits in DCB + 6. However, if the command terminates with an error, the bits in 
DCB+7 are used instead. 

The ninth word is unused by the disk controller, and may be used by the Alto program to facilitate 
chained disk operations. The tenth word contains the disk address at which the current operation is to 
take place. 

ocb: Pointer to next command block. 



DCB + l: 


Status. 




DCB+2: 


Command. 




OCB +3: 


Header block pointer. 




ncB+4: 


Label block pointer. 




nCB~h5: 


Data pointer. 




ira)+6: 


Command complete no-error interrupt bit mask, 


OCB +7: 


Command complete error interrupt bit mask. 


DCB+8: 


Currently unused. 




DCB+9: 


Disk address. 




iddress woi 


;'d A contains the following 


fields: 


Mia.D 


RANGH 


SIGNIMCANCH 


A[0-3] 


0-13B 


Sector number. 


A[4-12] 


0-625B (Model 44) 
0-312B (Model 31) 


Cylinder number. 


A[13] 


0-1 


Head number. 


A[14] 


0-1 


Disk number (see d 



on Model 44. 1 is optional second Model 31 drive. 
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A[15] 0-1 noimally. 

1 if cylinder is to be addressed via a hardware 
"restore" operation. 

A disk command word C contains the following fields: 

Fnn 1) RANGE SIGNIFICANCE 

C[0-7] 110b Checked to verify that this is a valid disk command. 

C[8-9] 0-3 if Header block to be read. 

1 if Header block to be checked. 

2 or 3 if Header block to be written. 

C[10-ll] 0-3 if Label block to be read. 

1 if Label block to be checked. 

2 or 3 if Isabel block to be written. 

C[12-13] 0-3 if Data block to be read. 

1 if Data block to be checked. 

2 or 3 if Data block to be written. 

C[14] 0-1 normally. 

1 if the command is to terminate immediately after 
the correct cylinder position is reached (before any 
data is transferred). 

C[15] 0-1 xoR'ed witli A[14] to yield hardware disk number. 

A disk status word S has the following fields: 

SIGNIMCANCE 

Current sector number. 

One can tell whetlier status has been stored by 
setting this field initially to and then checking for 
non-zero. 

S[8] 0-1 1 means seek failed, possibly due to illegal cylinder 

address. 

1 means seek in progress. 

1 means disk unit not ready. 

1 means data or sector processing was late during the 
last sector. Data and current sector number 
unreliable. 

1 means disk interface was not transferring data last 
sector. 

1 means checksum error. Command allowed to 
proceed. 

means command completed correctly. 

1 means hardware error (see S[8-ll]) or sector 
overflow. 

2 means check error. Command terminated instantly. 

3 means disk command specified illegal sector. 

Several clever programming tricks have been suggested to drive the disk controller. I'or an initial 
program load, kblk should be set to point to a disk command block representing a read into location 
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Error Interrupt bit mask 
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Status at beginning of sector 


523 


Disk address of most recent KCB 


524 


Sector interrupt bit mask 



Reserved Page 1 Locations 



Disk Command Block (KCB) 



Figure 8 -- Disk Data Structures 
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STRT. Before setting kblk, the Alto program should put a jmp STRT instruction in STRT; afterward it 
should jump to S'l'R'r. The disk controller transfers data downward, from high to low addresses, so that 
when location STRT is changed the reading of the block is complete. (See section 3.4 on the standard 
bootstrap loading microcode.) 

Another trick is to chain disk reads through their label blocks. That is, the label block for sector n 
contains part of the disk command block for reading sector n + 1, and so on. 

6.1 Disk Controller Implementation 

l^hc following walk-through of an average day in the life of the standard disk controller is not intended 
for the casual reader, but rather as a roadmap to ease the pain of learning the innermost workings of the 
controller. If you really want to benefit from this next section, you should have a copy of tlic standard 
disk controller microcode and logic drawings close at hand. 

The disk controller consists of a modest amount of hardware and two microcode tasks (the sector task 
and the word t^isk). Communication with the emulator is via the four special main memory words, the 
disk command blocks, and the intermpts described earlier. In following few paragraphs the actions of the 
standard disk controller microcode are described. Occasionally it may be unclear whether the actor is 
microcode or hardware, deferring to microcode listings and/or logic drawings will resolve any such 
questions. 

The sector task is awakened by a sector signal from tlie disk. When awakened, it stores the status of the 
disk and controller in the special disk status word (kblk + 1). In addition, if this sector signal terminates 
a disk command (for example, a data transfer during the previous sector), the status of the disk and 
controller are stored in the status word of the disk command block containing the terminated command, 
and the command block pointer (khi.k) is advanced. If a command was terminated witli an error, KBLK 
(Dcn pointer) is set to and KBiX + 2 (current disk address) is set to -1. T'hc effect of this is to cause the 
disk controller to abandon the current disk command chain and to forget where the disk arm is 
positioned. 

Next, the sector task considers the first command on the disk command block chain (by using kblk). If 
there is none, or if the disk unit is not ready to accept a command, the sector task goes to sleep until the 
next sector pulse. Otherwise, the sector specified in the new conunand is verified to be less than 13. 
'J'hen, the disk and cylinder specified in the new command arc compared with those stored in KBLK + 2 
(current disk address), and then the new disk address is stored in kblk + 2 and in the disk controller 
hardware. Part of the new command is also stored in the hardware. If the comparison is unequal, a seek 
is initiated and the sector task goes to sleep until the next sector pulse. 

If the comparison was equal, the sllkok hardware flag is tested. If that is OK, then the no-transfer bit 
of the disk command (bit 14 of the command word of the current disk command block) is tested to see 
whether a data transfer is required. If not, the sector task goes to sleep such that the command will 
terminate at the next sector pulse. If a data transfer is required, the specified sector number and the 
current disk sectt)r number arc compared. If unequal, the sector task goes to sleep until the next sector 
pulse. If sector numbers are equal, awakening of the word task is enabled and the sector task goes to 
sleep such that the command will terminate at the next sector pulse. 

The word task awakens when a word has been processed by the disk controller hardware and the word 
txisk has been enabled by the sector task. First, a starting delay is computed, based on wheUier the 
current record is to be read or written. Second, control is dispatched based on the current record 
number. A record length and main memory starting address are computed based on tlic record number. 
In addition, special starting delays arc computed for record number 0. The disk unit is set into the delay 
mode appropriate for the operation (read/write) and the word task goes to sleep the appropriate Jiumbcr 
of times. 
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Then a sync word is written (if writing) or awaited (if reading). Finally the main transfer loop is entered. 
Here the word count is decremented, a memory operation is started, and control is dispatched on the 
transfer type. If read, the disk word is stored in memory. If write, the memory word is sent to the disk. 
If check, the memory word is compared with 0. If non-zero, the disk and memory words are compared. 
An unequal compare here terminates this sector's operation with an error immediately. If tlie memory 
word is 0, it is replaced by the disk word. In any case, the checksum is updated and control returns to 
the main transfer loop. Due to the Al.u functions available, the main transfer loop moves in sequence 
from high to low main memory addresses. 

After the word count reaches 0, the checksum is written or checked. A checksum error will be noted in 
the status word, but will not terminate this sector's operation. A finishing delay is computed, based on 
the current operation, the disk unit is set into a delay mode appropriate to the operation, and the delay 
happens. Mnally, all disk transfers arc shut off, the record number is incremented, and control returns to 
the beginning of the word task. 

To accomplish all this, the disk controller hardware communicates with the microprocessor in four ways: 
first, by task wakeup signals for the sector and word tasks; second, by five task-specific i'2's which modify 
the next microinstruction address; third, by seven task-specific n's, four of which activate bus destination 
registers, and the remaining three of which provide useful pulses; and fourth, by two task-specific BS's. 
The following tables describe the effects of these. 



J'i VALUE 

17b 



16n 



15b 



NAME 
KDATA^- 



KADR<- 



KCOM<- 



MlJ 


CLRSIAT 


]3» 


INCRHCNO 


12» 


KSrAT«- 



EFFECT 

The KDATA register is loaded from BUS[0-15]. This register is the 
data output register to the disk, and is also used to hold the disk 
address during kadr^ and seek commands. When used as a disk 
address it has the format of word A in section 6.0 above. 

This causes the kadr register to be loaded from BUS[8-14]. This 
register has the format of word C in section 6.0 above. In 
addition, it causes the head address bit to be loaded from 

KDArA[13]. 

This causes the kcom register to be loaded from BUS[l-5]. Ihc 
KCOM register has the following interpretation: 

(1) XFEROFF - 1 inhibits data transmission to/from the disk. 

(2) WDINHIB = 1 prevents the disk word task from awakening. 

(3) BCLKSRC = 1 takes bit clock from disk input or crystal clock, 
as appropriate, bcfksrc = 1 forces use of crystal clock. 

(4) WFFO = holds the disk bit counter at -1 until a 1-bit is read. 
WFFO = 1 allows the bit counter to proceed normally. 

(5) SFNDADR - 1 causes KDATA[4-12] and kdata[15] to be 
transmitted to disk unit as track address, senoadk = Inhibits 
such transmission. 

Causes all error latches in disk controller hardware to reset, clears 
KS'rAT[13]. 

Advances the shift registers holding the KADR register so that they 
present the number and read/write/check status of the next record 
to the hardware. 

KSTAT[12-15] are loaded from BUS[12-15]. (Actually. BUSI131 is 
ORcd into KSTAr[13].) ^Fhis enables the microcode to enter 
conditions it detects into the status register. 
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n VALUE 


NAME 


10b 


INIT 


llB 


RWC 


12b 


RHCNC 



llB STROBE Initiates a disk seek operation. The kdata register must have 

been loaded previously, and tlie sendadr bit of the KCOMM 
register previously set to 1. 

EFFECT 

next^^next or (// wdtaskact and wdinit) (hen 31n else 0) 

NEXT<^NEXT OR (// Current record to be written ihen 3 elseif 
current record to be checked (hen 2 else 0) 

NEXT^NEXT OR MAP (current record number) where 

MAP{0) = 

MAP(1) = 2 

MAP(2) = 3 

MAP(3) = 1 

NEXT^NEXT OR (//current command wants data transfer (hen 1 
else 0) 

NEXT <- NEXT OR (//disk not ready to accept command (hen 1 else 
0) 

NEXT<-NEXT OR (// fatal error in latches then else 1). 

NEXT^NEXT OR (// scck strobc Still on then 1 else 0). 

EFFECT 

The KSTAT register is placed on bus. It has the format of a disk 
status word. 

The disk input data register is placed on BUS. 

A feature of interest mostly to the diagnostic microcode writer is that if one reads the disk input data 
register while writing, what should appear is delayed written data correctly aligned on word boundaries. 
This is a painless way of checking most of the data paths in the disk controller hardware. 



13B 


XFRDAT 


14b 


SWRNRDY 


15b 


NFER 


16b 


STROBON 


BS VALUE 


NAME 


3 


<- KSTAT 


4 


<- KDATA 
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7.0 ETHERNET 

An Ethernet is the principal means of communications between an Alto and the outside world. The 
object was to design a communication system which could grow smoothly to accommodate several 
buildings full of personal computers and the facilities needed for their support, 'i'he Ethernet is a 
broadcast, multi-drop, packet-switching, bit serial, digital communications network: it connects up to 256 
nodes, separated by as much as 1 kilometer, with a 2.94 megabits/sec channel. Control of the Ethernet is 
distributed among the communicating computers to eliminate the reliability problems of an active central 
controller, to avoid a bottleneck in a system rich in parallelism, and to reduce the fixed costs which make 
small systems uneconomical 

The Ethernet is intended to be an efficient, low-level packet transport mechanism which gives its best 
efforts to delivering packets, but // is not error free. Even when transmitted without source-detected 
interference, a packet may not reach its destination without error; thus, packets are delivered only with 
high probability. Stations requiring a residual error rate lower than that provided by this bare packet 
transport mechanism must follow mutually agreed upon packet protocols. 

Alto Ethernets come in three pieces: the transceiver, the interface, and the microcode. The transceiver is 
a small device which taps into the passing Edier, inserting and extracting bits under the control of the 
interface while disturbing the Ether as little as possible. The same device is used to connect all types of 
Ethernet interfaces to the Ether, so the transceiver design is not specific to the Alto, and will not be 
described here. The following sections describe the programming characteristics of the Alto Ethernet, 
and then the implementations of the interface and microprogram. 

7.7 Progtamnung Characteristics 

Programs communicate with the interface and the microcode via the emulator instruction SIO and 9 
reserved locations in page 1. Word counts, buffer addresses, etc., are put in the appropriate locations and 
then SIO is executed with an Ethernet command in ACO. 

The special page 1 memory locations and their functions arc: 

KPLOC = 600u: Post location. Microcode and interface status information is posted in this 

location when a command completes. 

I'-BLOC - 601b: Interrupt bit location. The contents of this location is ORcd Into NWW when 

a command completes, thereby causing interrupt(s) on the channels 
corresponding to the one bits in EB1.0C. 

HKLOC - 602b: End count location. The number of words remaining in the main memory 

buffer at command completion is stored here as part of the posting 
operation. 

ivl.LOC ^ 603b: Load location. This location is used by the microcode to hold a mask of 

ones shifted in from the right for generating random retransmission intervals. 
lUl.oc should be zeroed before starting the transmitter. 

L'lCLOC ~ 604b: Input count location. The emulator program should put the size of the 

input buffer (in words) into this location before starting the receiver. If a 
packet arrives that is longer than HIC1.0C, the receiver will post an Input 
Buffer Overrun error status. 



HUM DC - 605b: 



Input pointer location. The emulator program should put a pointer to the 
beginning of the input buffer into this location before starting the receiver. 
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EOCLOC = 606b: Output count location. The emulator program should put the size of the 

output buffer (in words) into this location before starting the transmitter. By 
convention, packets should not be substantially longer than 256 words. 



noPLOC = 607n: 



Output pointer location. The emulator program should put a pointer to the 
beginning of the output buffer into this location before starting the 



transmitter. 



miLOC = 610b: Host address location, lliis location must contain zero in the left byte and 

tlic host address in the right byte. The microcode matches this host address 
against the first byte of a passing packet to decide whether to accept it. 

SIO passes commands to the interface and returns the host address of the Alto. Commands to the 
Ethernet interface are encoded in the two low order bits of ACO and have the following meaning (the 
remaining bits of ACO may be interpreted by other devices and thus should be zero): 

AC0[14-15]: Do nothing 

1 Start the transmitter 

2 Start the receiver 

3 Reset the interface and microcode. 

The host address, returned in AC0[8-15] by Sio, is set by wires on the Alto backpancl. This number is 
normally put in rjiLOC thereby causing packets with destination addresses matching the address set with 
the wires to be accepted by the receiver. For more on addressing, see below. 

Upon completion of a command, eploc contains the status of the microcode in the left byte and the 
status of the interface in the right byte. The possible values of the microcode status byte, hploc[0-7], 
and their meanings are: 

PP].OC[0-7] - 0: Input done. If the hardware status byte is 377n, the interface believes the 

packet was received without error, 

p:pi.OC[0-7] = 1: Output done. If the hardware status byte is 377b, the interface believes the 

packet was sent without error. The number of colHsions experienced while 
sending the packet is log2(PLi.oC/2 + l)-l. 

i:PLOC[0-7] = 2: Input buffer overnm. The received packet was longer than the buffer, and 

the excess words were lost. Ikiffer overrun causes an early exit from the 
microcode input main loop, so it is likely that the CRC error and Jncomplete 
transmission bits in the hardware status byte will be set." 

PPLOC[0-7] = 3: Load overflow. The transmitter experienced 16 consecutive collisions 

(assuming plloc was zeroed before starting the transmitter) while trying to 
transmit tlie packet described by eoploc and UOCLOC. P[.loc[0] will be 
one. 

PPi.oc[0-7] - 4: The command (input or output) specified a zero length buffer. 

rPLOC[0-7] = 5: Reset. Generally indicates that a reset command (sio with AC0[14-15] = 3) 

was issued to the interface when it was idle or any command was issued 
when it was not idle. 

p[*i.oc[0-7] - 6: Microcode branch conditions that should never happen cause this code to be 

posted if they do happen. 

PPLOC[0-7] = 7-377b: The microcode does not generate these values for status. 

Note that the microcode statuses arc small integers and not individual bits as in die interface status byte. 
Bits in the interface status byte, fppoc[8-15], are low true. When zero, their meanings are: 
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EPLOC[8-9] Unused. 'Iliese should always be one. 

EPLOC[10] Input data late. The interface did not get enough processor cycles. 

EPL0C[11] Collision. 

i^PL0C[12] Input CRC bad. 

l-PL0C[13] Input command issued. (ac0[14] in last SIO) 

LTL0C[14] Output command issued. (acO[15] in last SIO) 

mM.oc[15] Incomplete transmission. The received packet did not end on a word 

boundary. 

Command completion can be detected in two ways: (1) zero eploc and wait for it to go non-zero, or (2) 
set bits in Fm.0C corresponding to the channels on which interrupts are desired at command completion. 

When a program wishes to send a packet, it must first turn off the receiver if it is on. If the receiver is 
actively copying a packet into memory, the transmitter should wait for the receiver to finish (a maximum 
of about 1.5 ms. assuming 250-300 word packets). The program can tell whether the receiver is actively 
transferring or idle by zeroing the first word of the input buffer before starting the receiver. When the 
program wants to start the transmitter, it checks the first word of the input butTcr: if it is still zero, input 
has not yet begun and the interface may be reset and the transmitter started with a high probability of 
not missing an incoming packet. There is still a small window between testing the word and starting the 
transmitter when a packet can arrive and be missed, but paragraph two of this chapter warned that the 
Ethernet is not error free anyway, so missing a few more packets should be harmless. 

A program can determine the size of an input message (and though not too useful, the number of words 
transferred to the interface by the output microcode) by subtracting the contents of EELOC from the 
original buffer count in EICLOC or eocloc. The microcode never modifies the buffer count or pointer 
locations. 

To keep the receiver listening as much of the time as possible, if eicloc is non-zero when an output 
command is issued, the microcode will start the receiver 'under' tlic transmitter: while the transmitter is 
counting down a random retransmission interval after a collision, the receiver is listening. If a message 
arrives addressed to the receiver, the transmission attempt is aborted and the incoming message is 
received into the buffer described by i-jcloc and eiploc. The transmit command is not executed in this 
case, and must be reissued. The microcode status byte in eploc will have an 'input done' status value if 
the transmission attempt was aborted by an incoming packet. 

The first word of all Kthernet packets must contain the address to which the packet is destined in the left 
byte, and the address of the sender (or 'source') in the right byte. Receivers examine at least the 
destination byte, and in some cases (not in Altos) the source byte to determine whether to copy the 
message into memory as it passes by. Address zero has special meaning to the Ethernet. Packets with 
destination zero are broadcast packets, and all active receivers will receive them. If a program wishes to 
receive all packets on the Ether regardless of address (useful for debugging and diagnostic programs), it 
should put zero into I^IIEOC instead of the host number returned by sio. A host which does this is said 
to be promiscuous. Address 377n is reserved for Ethernet booting (see section 3.4). Address 376b is 
reserved as the destination for diagnostic messages. 

By convention, the second word of all Ethernet packets is the packet type. Communication protocols 
using the lithernct should set the type word to describe the protocol to which the packet belongs (for 
example Pup protocol packets have 1000b in the type word), llic type word is purely a software 
convention; no P'thcrnct hardware or microcode interprets it. 
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7.2 Ethernet Hardware 

The EtJiernct hardware consists oif a FIFO buffer, an output shift register and phase encoder, a clock 
recovery circuit, an input shift register, a CRC register, and one microcode task. The hardware is shown 
in block diagram ft)rm in Figure 8. Packets on the Ether arc phase encoded and transmitter 
synchronous: it is the responsibility of the receiver to decide where a packet begins (and thus establish 
the phase of the data clock), separate the clock from the data, and deserialize tlic incoming bit stream. 
The purpose of the write register is to synchronize data transfers between the input shift register whose 
clock is derived from the incoming data, and the FIFO which is synchronous to the processor system 
clock. I'hc large r<if'0 is necessary because the Ethernet task has relatively low priority, and the worst 
case latency from request to task wakcup is on the order of 20 microseconds. The phase encoder uses 
the system clock (one Ethernet bit time is two clock periods). 

Included in the clock recovery section is a one-shot which is retriggercd by each level transition of a 
passing packet. This detects tlie envelope of a packet and is called its *carrier\ Ethernet phase encoders 
mark tlie beginning of a packet by prefixing a single 1 bit, called the sync bit, to the front of all 
transmissions. The leading edge of the sync bit of a packet will trigger the carrier one-shot of a listening 
receiver and establish the receiver clock phase. The sync bit is clocked into the input shift register and 
recirculated every 16 bit times thereafter to mark the presence of a complete word in the register. If 
carrier drops without the sync bit at the end of the register, the transmission was incomplete, and is 
flagged in the hardware status bits. When the shift register is full, the word is transferred to the write 
register where it sits until the MFO control has synchronized its presence and there is room to accept it. 
If the shift register fills up again before the word has been transferred from the write register to the FIFO, 
data has been lost and the jnput data late flip flop is set. 

Ethernet transmitters accumulate a 16 bit cyclic redundancy checksum on tlie data as it is serialized, and 
append it to an outgoing packet after tlie last data word. As a receiver deserializes an incoming packet it 
recomputes the checksum over the data plus the appended CRC word. If the resulting receiver checksum 
is non-zero, the received packet is assumed to be in error, and the condition is flagged in the hardware 
status byte. Since the CRC is of no interest to the emulator program, a wakcup request to empty data 
from the I'H^O is only made when it contains two or more words. This reduces the effective size of the 
Fii'O by one word, but insures that tlic CRC will be left behind at the end of a packet. 

The phase encoder is started when the microcode has decremented the countdown to zero, there is no 
carrier present, and either the vwo is full, or if the message is less than 16 words long, all of it has been 
transferred to the Mi'O. The phase encoder will not start up while there is carrier present. This means 
that collisions can only happen because of delay in sensing carrier between widely spaced transmitters. 
Collisions are detected at the transceiver by comparing the data the interface is supplying to the data 
being received off the Ether. If the two arc not identical, a signal is returned to the interface which sets 
the collision. flip flop causing a wakcup request to the microcode which resets the interface. Countdowns 
are accomplished by setting a flip flop from the microcode which will cause a wakcup request on the 
next occurrence of swakmri'. This makes the grain size of countdowns about 38 microseconds. 

The interface and the transceiver are connected together by three twisted pairs for signals plus two 
supply voltages and ground supplied from the interfcice. The signals are (1) transmitted data to the 
transceiver, (2) received data from the transceiver, and (3) the collision signal from the transceiver 
indicating interference. 

7.5 Ethernet Microcode 

The Ethernet microcode uses a single task and 2 registers in r: 
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HCN'ni: The number of words remaining in tlie buffer. 
epni'r: Points at the word prior to that next to be processed. 

The task and R registers are shared by input and output so that at any time they are (1) unused, (2) 
ti'ansmitting a packet, or (3) receiving a packet. When an Ethernet SIO is issued while the Ethernet 
microcode is reset, the code dispatches on whether it is an input, output, or reset command. 

Each Ethernet SIO has a result which is posted when the command completes. The state of the 
microcode and hardware at the time of the post is deposited in i:ploc, the contents of ecntr is 
deposited in niiLOC, and the contents of EBL.OC is ORed into NWW. Note that resetting the interface with 
EBI.OC non-/ero will result in an interrupt. 

An input command (Sio with AC0[14:15] = 2) causes the microcode to start the input hardware searching 
for the start of a packet and then block. When a packet begins to arrive, the hardware wakes up the 
microcode which compares the packet's address against the filtering instioictions left in F.HLOC by the 
emulator program. The packet will be accepted if any of three conditions is true: (1) If FiiLOC is zero, 
the receiver is said to be promiscuous - all packets are accepted; (2) if the destination address (left byte of 
the first word) of the packet is zero, the packet is a broadcast packet - all receivers accept broadcast 
packets; or (3) if tlie destination byte matches the right byte of r.HLOC - the packet was sent to that 
specific host. If none of these conditions is met, the packet is rejected by restarting the receiver, which 
causes it to ignore the current packet and to hunt for the beginning of the next packet. If the packet is 
accepted, the microcode enters the input main loop. 

The input main loop first loads ECNTR and fpntr from ficloc and niPLOC. Note that mcLOC and 
laPLOC are not read until the receiver is committed to transferring data to memory, which may be long 
after the receiver was started; therefore, these locations should not be disturbed while the receiver is on. 
The main loop repeatedly counts down the buffer size in kcntr and advances the buffer pointer in 
FPN'FR depositing packet words until either the hardware says that the packet has ended or the buffer 
overflows; in either case, the input operation temiinates and posts. 

An output command (sio with AC0[14-15] = 1) causes the microcode to compute a random 
retransmission interval, wait that long, and then start transmitting the packet described by HOCl.OC and 
liOPLOC. The retransmission interval is computed by ANr:)ing the contents of ELLOC with the contents of 
R37, the low part of the real time clock (i:leoc is not modified). Then a one bit is left shifted into 
I'l.LOC and the high order bit of the result is tested. If the high order bit is on, the transmission attempt 
is aborted with a 'load overflow' microcode status. The above process is repeated each time the 
transmitter detects a collision while transmitting the packet. If HLLOC started out zero, each collision will 
double the value of ELLOC, thus doubling the mean of the random number generated by ANDing ELl>OC 
with the real time clock. If 16 consecutive collisions occur without successfully transmitting the packet, 
the attempt is aborted. 

The retransmission interval is decremented every 38.08 microseconds (the memory refresh task wakeup 
signal is used for this) until it reaches zero, at which time ecntr and la'N'i'R are loaded from EOCLOC 
and E.OPLOC and the transmitter part of the interface is started. This may occur long after the emulator 
program issued the output command, so EOCLOC and i^OPLOC should not be changed while the 
transmitter is on. Note that the mean of the first retransmission interval will be zero, so the first 
transmission attempt will begin immediately. Actual transmission of the packet does not begin until the 
rn-0 has been filled by the output main loop (or if the packet is smaller than the Ell^^O, until all of the 
packet is in the l-li-o) and there is silence on the Ether. If eicloc is non zero while the transmitter is 
counting down a retransmission interval, the receiver is turned on and if a packet arrives with an 
acceptable address, the transmission attempt is forgotten and the microcode enters the input main loop as 
if an input command had been issued. 

The output main loop repeatedly counts down the packet length in ecntr and advances the address in 
l:pntr taking words from the output buffer and putting them in the vwo until cither the main memory 
buffer is emptied or a hardware condition aborts the operation. The output main loop is awakened for a 
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datii word once every 5.44 microseconds on the average. The microcode signals the hardware when die 
main memory buffer is empty and waits for the hardware to terminate; it then posts status. 

A reset command (sio with AC0[14-15] - 3) will always bring the interface back to a reset state. If the 
receiver was on, it is stopped even if a packet was pouring into memory. If the transmitter was on, it is 
stopped, even if it was in the middle of transmitting a packet (the result to the receiver of the interrupted 
packet will almost certainly be an incomplete transmission and incorrect CRC). Status will immediately 
be posted in fploc: the microcode will post the reset status (5) in the microcode status byte, and the 
hardware will post the conditions at the time of the reset in the hardware status byte, llic contents of 
the p:cntr r register will be deposited in eeloc, and the contents of ebeoc will be ORed into NWW, 
possibly causing intcrmpts. After doing this, the interface and microcode are reset and ready for another 
command. 

The task specific microcode functions for the Ethernet interface are summari/.ed below. 

EIDFCT * BS = 4 Input Data Function. Gates the contents of the Fir^o to BUS[0-15], and 

increments the read pointer at the end of the cycle. 

EILFCT * fi = 13b Input Look Function. Gates the contents of the FIFO to BUS[0-15] but does 

not increment the read pointer. 

BM'Cr fi = 14b Post Function. Gates interface status to BUS[8-15]. Resets the interface at 

the end of the cycle. 

EWFCT fi = 15b Countdown Wakeup Function. Sets a flip flop in the interface that will 

cause a wakeup to the Ether task on the next tick of swakmrt. This 
function must be issued in the instruction after a TASK, The resulting 
wakeup is cleared when the F'ther task next iiins. 

eodfct F7 = 10b Output Data Function. Loads the Fii-0 from BUS[0-15], then increments the 

write pointer at the end of the cycle. 

EOSFCT F7 = 11b Output Start Function. Sets the OBusy flip flop in the interface, starting 

data wakeups to fill the FIFO for output. When the Fii'O is full, or EEFct has 
been issued, the interface will wait for silence on the Ether and begin 
transmitting. 

ERBFCT i^==:12b Reset Branch Function. This command dispatch function merges the ICMO 

and OCMD flip flops, into nexi[6-7]. These flip flops are the means of 
communication between the emulator task and the Ethernet task. The 
emulator task sets them from BUS[14-15] with the starif function, causing 
the Ethernet task to wakeup, dispatch on them and then reset them with 

EPFCT. 

Eiii'CT F2=13b End of transmission Function. This function is issued when all of llie main 

memory output buffer has been transferred to the FIFO, eefct disables 
further data wakeups. 

liBFCT F7=:14b Branch Function. ORs a one into NFxr[7] if an input data late is detected, 

or an SIO with AC0[14:15] non-zero is issued, or if the transmitter or receiver 
goes done. ORs a one into Nl^xr[6] if a collision is detected. 

ECur'CT P7-15B Countdown Branch Function. ORs a one into NExr[7] if the Mi"0 is not 

empty. 

F^lSFCr F2=: 16b Input Start Function. Sets the iBusy flip flop in the interface, causing it to 

hunt for the beginning of a packet: silence on the Ether followed by a 
transition. When the interface has collected two words, it will begin 
generating data wakeups to the microcode. 
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* These functions have a pecuHar timing restriction associated witli them. The microinstruction that 
executes one of them must stop the clock for one cycle. On Alto I, the microprogrammer must do 
this using memory timing (i.e., by referencing MD in the same microinstruction, during the third or 
fourth cycle of a memory reference). On Alto M, the hardware automatically stops the clock for 
one cycle when necessary; however, due to a design error, the instruction following the one 
specifying EiDFCr or mi.FCT is occasionally stopped instead. Consequently, the programmer must 
not permit a task switch to occur between these two microinstructions, nor start a memory 
reference in the following microinstruction. 
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8,0 CONTROL RAM, ROM, AND S REGISTERS 

In addition to the iK microinstruction ROM containing the standard emulator and I/O microcode, an Alto 
may contain additional microinstruction memory in the form of cither ROM or RAM; these are 
accompanied by additional registers, called s registers, whose purpose and operation arc similar to the 
standard R registers. 

Several different configurations exist, depending on tlie Alto vintage: 

iK RAM All Altos have at least Ik of read/write microinstruction memory and one bank of 31 S 
registers. (At one time these were optional on Alto I, but they arc now considered standard.) 

2k ROM Certain Alto lis have 2k of read-only microinstruction memory rather than iK. The first iK 
contain the standard emulator and I/O microcode, and the second iK may be programmed 
with additional microcode. This configuration includes the iK RAM and 31 S registers 
described previously. 

3k ram Certain other Alto lis have 3k of read/write microinstmction memory and 8 banks of 31 S 
registers. 

8J RAM-Related Tasks 

llic control RAM and S registers perform data manipulation (as distinct from microcode fetching) 
functions in response to certain values of the Fi and BS fields of the microinstruction. Not all tasks are 
likely to be interested in these functions. Moreover, not all tasks will have the appropriate values of the 
i\ and ns fields uncommitted. A RAM-related task is defined as one during whose execution the control 
RAM card will respond to Fi and i^s fields of microinstructions. The standard Alto is wired so that the 
ennilator task is the only RAM-related task. At most two other tasks can be made RAM-related by a 
simple backpancl wiring change. 

8,2 Processor Bus and ALU Interface 

The Alto's AFU output and processor bus are each 16 bits wide and its microinstruction bus is 32 bits 
wide, so loading the control ram from the Ai.u output and reading the control RAM (or ROM) onto the 
processor bus is slightly clumsy. It is done by using tlie RAM-related Fi's WRTRAM and RDRAM (sec 
Appendix A). 

For both reading and writing, the control ram address is specified by the conti'ol RAM address register 
(sec Mgurc 2), which is loaded fi'om the ALU output whenever T is loaded from its source. This load 
may take place as late as the microinstruction in which wrtram or rdram is asserted. The bits of the 
ALU output have the following significance as a control RAM address: 

mr USF 

0-1 Ignored (should be zero). 

2-3 BANKSEL - Selects ram bank in 3k ram configuration; ignored when operating on 

ROM. 

RAMO 

1 RAMI 

2 RAM2 

3 Undefined 
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4 RAM/ROM 

Means operate on the control RAM. 

1 Means operate on the control ROM. (This doesn't quite work the way you might 
think. See section 8.8 for details.) 

5 iiALFSEL - Ignored when writing 

Means read out the low-order 16-bits of the addressed word. 

1 Means read out the high-order 16-bits of the addressed word. 

6-15 Word address (0-1023). 

Since it is expected that reading the control RAM will be a relatively infrequent operation, a single 
assertion of rdram reads out only one half of a 32-bit control ram (or ROM) word onto the processor 
bus. To read out both halves, the control RAM address register must be loaded twice and RDRAM 
invoked twice. Data resulting from rdram is AND'ed onto the processor bus during the microinstruction 
following that in which the rdram was asserted. 

hi contrast, it is expected that writing into the control RAM will occur frequently. Therefore a single 
application of wrtram writes both halves of a control ram word at once. The M register contents (sec 
section 8.7) after the microinstmction containing the wrtram will be written into the high-order half of 
the addressed control ram word. The ALU output during the microinstruction following the wrtram 
will be written into the low-order half This protocol mates well with doubleword main memory reads, 

8.3 Microinstruction Bus Intefface 

The correspondence of ALU output bits with microinstaiction fields appears in the following table: 

High/Low Order Bit of ALU Meaning Value in 

Malfword Output Example 

H 0-4 R Register Select 

H 5-8 ALU Function Select 

H 9-11 Bus Data Source 5 

H 12-15* Function 1 2 

L 0-3* Function 2 

L 4 LoadT 

L 5* Load L 1 

L 6-15 Next micro address 325b 

Fields denoted by * arc represented with their high-order bit inverted; this is an artifact of 
hardware microinstruction decoding. 

As an example, consider the representation of the microinstruction 

L^MD, TASK. :LOCA: 

where loca is 325h. The values for the various microinstruction fields are listed in the table above. 
After complementing the appropriate high-order bits and concatenating, we see that tlic microinstruction 
above would be represented as 132h in its high-order halfword and 100325b in its low-order halfword. 

8.4 Microinstruction Memory Banks 

An alert reader will by now have noticed tliat the Nixi' field of each microinstruction provides a 10-bit 
address, and that more bits are required to fully address the microinstruction memory, llie Ml memory 
is divided into up to four banks of 1024 instructions each: 
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NAMB WHAT 

MI ROMO The Standard microcode ROM. 

Ml ROM I Second bank of ROM in the 2k ROM configuration. 

MI RAMO The standard microcode writeable ram. 

Ml rami Second bank of ram in the 3k ram configuration. 

MI RAM2 Third bank of RAM in the 3k ram configuration. 

Switching among banks is controlled in two ways: (1) a RAM related task already running may *'switch" 
banks, and (2) it possible to initiate a task in either ROMO or ramo. 

Bank switching is accomplished with a special transfer mechanism, available only to the emulator task, in 
the form of swMOnn, a RAM-related n. swmode will switch the bank of the running task, taking effect 
after the microinstruction following tliat in which the SWMODH appears. In other words, the emulator 
task SWMODR behaves much like an address modifier. Tasks other than the emulator cannot switch 
banks. ^J'he effect of swmodh depends on tlie rom/ram configuration, the bank in which the task is 
currently executing, and the value of next in the instruction following the one that asserts SWMODE. 

In the Ik ram configuration (neither the 2k ROM nor the 3k ram option installed): 

If currently go to NEXT in 

executing in 



ROMO 
RAMO 



RAMO 
ROMO 



In the 2k ROM configuration (which includes iK of ram): 
If currently and NExr[l] = then else 



exccutmgin 




go to NEXT in 




go to NEXT in 


ROMO 
ROM! 
RAMO 




RAMO 
ROMO 
ROMO 




ROM! 
RAMO 
ROMl 


the 3 k ram cor 


ifiguration: 






If currently 
executing in 




NEXT[1] = 

Nl{Xr[2]=0 NEXT[2]-1 


NEXT[1] = 1 

NExi[2]=o Nnxr[2]= 


ROMO 
RAMO 
RAMI 
RAM 2 




RAMO 
ROMO 
ROMO 
ROMO 


RAM2 
RAM2 
RAM2 
RAMI 


RAMI RAMO 
RAMI RAMI 
RAMO RAMO 
RAMO RAMO 



If the table above determines that control is to be transferred to the ram, and the RAM is not installed, 
control remains in tlie bank in which the task is currently executing. 

Many Alto lis have the 2k ROM capability but contain nothing in ROMi. In these Altos, the SWMODE 
operation is normally configured so that it behaves as if ROMl didn't exist (i.e., according to the first 
table rather than the second). This is determined by tlie chip in position 51 on the control board. If it is 
labelled SW2K then ROMl exists, but if SWIK then it does not. The alternate chip is kept in unused 
socket 76. 



SWMODI-: is actually defined in all RAM-related tasks, not just the emulator; however, it does not work 
correctly in tasks other than the emulator in Altos with the 2k ROM or 3k ram configuration. 

l^ach of the 16 micro-tasks may be started either in romo or in ramo when a hardware reset 
("bootstrap") operation is performed, regardless of whether the task is RAM-related. A 16-bit "reset mode 
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register" is used to determine which tasks will start in ROMO and which will start in RAMO. I'he emulator 
hi RMR<- causes the reset mode register to be loaded from the processor bus. The 16 bits of the 
processor bus correspond to the 16 Alto tasks in the following way: the low order bit of the processor 
bus specifics the initial mode of task 0, the lowest priority task (emulator), and tlic high-order bit of the 
bus specifies the initial mode of task 15, the highest priority task (recall that task / sUirts at location /; the 
reset mode register determines only which microinstruction bank will be used at the outset). A task will 
commence in romo if its associated bit in the reset mode register contains the value 1; otherwise it will 
start in ramo. Upon initial powcr-up of the Alto, and after each reset operation, the reset mode register 
is automatically set to all ones, corresponding to starting all tasks in ROMO. 

8 J Standard Emulator Access 

The standard emulator includes three instructions allowing basic access to the control RAM. More 
sophisticated access may be implemented by using the basic access primitives to write other access 
microcode into the control ram and then transferring control to that microcode. 

RDRAM (61011b) Read from Control RAM: 

Reads the control ram (or ROM) halfword addressed by ACi into ACQ. The microcode is: 

T^ACl, RDRAM; 

i.<-ALLONKS; (AND'ed with control RAM data) 

ACO<-L. :START; 

Note: In Alto lis running microcode version 2, this instruction does not work reliably if the 
lUhernet interface is running. 

WRTRAM (61012b) Write into Control ram: 

Writes acq into the high-order half and AC3 into the low-order half of the control RAM word 
addressed by ACT. The microcode is: 

i>ACi; 

L<-ACO, WRTRAM ; (This loads the M register) 

i>AC3; 

:S'1'ART; 

JMPRAM (61010b) Jump to Control ram; 

This emulator instruction provides a software interface to the swmodr instruction so that tlie 
emulator task may enter another bank in ram or ROM. The next emulator microinstruction will 
be determined from the value in ACl (mod 1024) - see the discussion of bank switching in 
section 8.4, Note thai (he instruction name (jump to RAM) is misleading, as SWMODK may jump to 
other places as well The microcode for jmpram is: 

1>ACJ,BUS. SWMODE; 
:NOVI^M; (NOVF.M = 0) 

This operation is fraught with peril. If done in error it is the one of the few emulator 
instructions which can cause the machine to plunge completely off the deep end. Although 
clever coders can use jmpram to determine whether or not a control RAM is installed, they arc 
better advised to make this determination using wrfram and rdram (see section 9.2.4). 
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8,6 Interpretation of Emulator Traps 

All unused opcodes except 77400b-77777b (which is used by Swat, the Alto debugger) and 6\xxx]\ where 
XXX is between and 377n, transfer to microlocation ramtrap with the instruction in L, the instruction 
cycled by 8 bits in the R-register xrhg, and the emulator's R-register PC counted one beyond the 
trapping instruction: 

RAMTRAP: SWMODE. :TRAP; 

TRAP: .... :TRAP1; 

Ihc result of this is that if your machine has a control RAM, these instructions will cause control to enter 
it at a location which is equal to TRAPl in the ROM microcode. If no RAM is present, the unimplemented 
opcode will be handled as described in Section 3.3. 

8J M and S Registers 

T'hc control ram card also includes an M register and 31 S registers. If the 3k' ram option is installed, 
there are 8 banks of 31 S registers (see below), llie M register is the analog of the basic Alto*s L register. 
It provides data for the s registers, which are analogous to the basic Alto's R registers. These additional 
registers are provided to case the tight constraint on R register availability which might limit the utility of 
tlic control RAM. 

The similarities between the M and L registers and between the R and S registers are striking. Both M 
and L are loaded from the output of the ALU, and only when the Load L bit of the microinstruction is 
active. R registers are loaded from i., and S registers are loaded from M. Both R and S registers output 
data onto the processor bus. Both R and S registers are addressed by the RSl^LECr field of the 
microinstruction. (Thus the same caveats which apply to the use of R37 apply to S37 (sec section 2.3 f)0 
Loading and reading of both R and s registers are controlled by the BS field of the microinstruction. 

Nevertheless there are considerable differences. To begin with, the M and s registers arc active only 
when a RAM-related task is executing. This means, for example, that in the highest-priority RAM-related 
task it is not necessary to save tlic value of M across a TASK, since no higher-priority task can change the 
value of M. (It is perilous to take advantage of diis 'Tcature", however, since several non-standard Alto 
peripherals make use of RAM-related tasks.) 

Unlike the data path from the L register to the R registers, the data path from the M register to the S 
registers contains no shifter. When an s register is being loaded from M, the processor bus receives an 
undefined value rather than being set to zero. The emulator-specific functions acsourcf and acdfst 
have no effect on s register addressing. And finally, when reading data from the S registers onto the 
processor bus, the RSHLUcr value causes the current value of the M register to appear on the bus. 
Crhis explains why there are only 31 useful s registers.) 

I^br the purposes of writing microcode, the s registers are assigned numbers 40n through 77b, and appear 
to the microassembler as if they simply extended the R register address space. Hence, for example, the M 
register is defined as R40. 

In the 3k ram configuration, there are 8 banks of 31 S registers rather than only a single one. Each 
RAM-related task has associated with it a 3-bit register bank number that determines which bank is 
referenced when a microinstriction specifics that an S register be read or loaded. There is an emulator Fl 
called HSR}^*- and a RAM-related v\ called SRB^ that sets the register bank number for the currently- 
executing task from bus[12-]4]. It is illegal to execute i:SRB<- or SRB^ in the last cycle before a task 
switch, i.e., in the microinstruction after a task is executed. 
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Note tliat the function code is different for emulator and non-emulator tasks: l^SRU*- is Fl = 15 and is 
defined only in the emulator task, while SRB^ is FJ.==13 and is defined in all RAM-related tasks besides 
tlie emulator. (ia = ]3 corresponds to rmr<- in the emulator, hi Altos without the 3k ram option, 
Fl = 13 performs rmr^ in all RAM-related tasks, including the emulator.) 

The register bank numbers are all reset to zero by a reset (bootstrap) operation, thereby causing the Alto 
to behave the same as a standard Alto with a single bank of S registers shared among all RAM-related 
tasks. 



8.8 Restrictions and Caveats 

1. Roth RDRAM and wrtram cause the microprocessor's system clock to stop for one cycle. This may 
yield unspecified results if the system clock is also stopped for some other reason (e.g., waiting for 
memory data). As a general rule, the system clock should run witliout hesitation during the 
microinstruction following a rdram or wrtram, except for the effect of the RDRAM or wrtram itself. 
On Alto I, there is an additional timing problem which manifests itself in some machines, for example, in 
the following microcode sequence: 

mar^foo; Starts memory reference 

I>FIH; Loads the control ram address register 

F^MD, WRTRAM; Save away the high-order word in M 

L^MD; Completes the write into the RAM 

What happens is that the last instruction suspends the system clock for one microinstruction, and some 
Alto 1 memories cannot keep the memory data good for two microinstruction times, so a parity error may 
occur. The data is actually stored in the RAM at the end of the first microinstruction time, so there is 
probably no error in the data even if a parity interrupt subsequently occurs. This "phantom" parity error 
may be averted by the following code, which takes three more microinstruction times, but docs not 
invoke the horrendous microcode overhead of parity error recording: 

MAR^FOO; Starts memory reference 

nop; Required for memory timing 

f*-md; Save away the low-order word 

'J'*-md; Save away the high-order word 

Tr:MP^L. l^t; 

r^-i'iF, WRl'RAM; Foads the address register, starts the write, 

F*-TFMP; Complete the write into the ram 

2. Unlike the control RAM, which can be addressed from 2 places, the control ROM gets its address only 
from the MPC RAM. Consequently, to read ROM location x, the instruction following the one with 
m==12b (RDRAM) must reside at location (x mod 1024). Therefore, you'll probably want to put the 
"reading" code in the ram: 

T^ACl. RDRAM, :X; Only ACl[4-5] are relevant 

X: F*-AFFONi':s; Flcrc the read takes place 

ACO^F. ... 

Note also that only ROMO can be read by these means. There is no known way to read ROMl. 

3. Some Alto Is have been observed not to evaluate the BUS=:0 function correctly when reading an S- 
regisLer during the first microinstruction after a task switch. 'Fhe same operation in other than the first 
microinslruction causes no difficulty. 
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9.0 NUTS AND BOLTS FOR THE MICROCODER 



9.1 Standard Microcode Conventions 

The microassembler which assembles microcode for the Alto is called Mu. , By convention, microcode 
source files have the extension .mu, and binary files have the extension .MB. Standard Alto I ROM 
microcode versions will be called AltoCodcx.MU; those for Alto II will be called AltoIICodeA:.MU. A 
microcode source file can be divided into three largely separable pieces: the language definitions, which 
tell Mu what names will be used for what octal values of what microcode fields; the constant definitions, 
which declare all constants that may later be referenced, and which cause the constant memory to be laid 
out; and the register declarations, microinstruction label declarations, and microinstructions. 

In order for microprograms written to execute in the ram to be compatible with those in the ROM, at a 
minimum the constants assumed by the ram microcode must be a subset of those declared by the ROM 
microcode, and the subset must reside in the same addresses. As a practical matter, one should preface 
one's RAM microcode by the same constant definitions which were used in the assembly of one's ROM 
microcode. In order to facilitate and encourage this compatibility, the file AltoConstsxMU will be 
maintained (the x corresponding to the latest AltoCodejc) containing definitions and constants for both 
Alto I and Alto II. These can be logically incorporated into other microcode assemblies via the 
"include" feature of Mu (#AltoConstsx.MU;). 

If one or more microcode tasks pass control back and forth between ROM and RAM, it becomes necessary 
to associate addresses with microinstruction labels. It is possible to do this completely generally, based 
on the microcode version number. A more limited solution is simply to fix the addresses of certain 
useful labels. The following addresses are guaranteed in all standard Alto I microcode versions after 20, 
and all standard Alto II microcode versions (and are included in AltoConstsxMU): 

AI)DRI^:SS LABKL SEMANTICS 

20n START Beginning of emulator's main loop; starts a new emulated 

instruction. 
37b TRAPi RAM location to which unfamiliar traps are sent; ROM location 

which implements trap sequence. 

Fast cyclic shift subroutine. 

Block transfer subroutine. 

Block store subroutine. 

Multiply subroutine. 

Divide subroutine. 

BITBLT subroutine. 

Cyclic shift dispatch table. 

In ROMi only -- see below 

A standard convention requires that location SWRHT in ROMi have the following microcode: 

SWRI'T: SWMODF*; 
iSFARl'; 

^rhis sequence enables a program to discover whether ROMi exists, i.e., whether the Alto has the 2k 
PROM option (see section 9.2.4). 



22 U 


RAMCYCX 


105n 


BIT 


10615 


BLKS 


120» 


MUL 


121 IJ 


DIV 


124b 


BriBLT 


160b 


IjO 


777b 


SWRET 
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9,2 Microcode Techniques Which Need Not Be Rediscovered 

For the most part, since the Alto is such a simple machine, writing Alto microcode is a straightforward 
exercise in rule-following. However, during the course of writing the few-odd thousand microinstructions 
which have ever been written by anybody for the Alto, a few microcoding techniques have emerged as 
particularly ingenious or useful or both. 'Hiey are recorded here for posterity. 

The beginning microcoder is advised to acquire a copy of the standard microcode (AltoCode;c.MU), and 
to study it carefully in conjunction with this manual. The knack comes easily. 

9.2.7 Microcode Subroutines 

You have probably already noticed that that the Alto hardware does not provide an easy way of doing 
microcode-level subroutine calls and returns. Several subroutine-call techniques have evolved. Two of 
these are used for RAM-to-ROM subroutine calls, and these will be presented first. 

PC CALL (used with blt, blks, mul, div, BnBLT) 

This call takes advantage of the assumption that nobody in his right mind would want the 
emulator to execute in the non-memory I/O area from 177000ii to 177777b. Therefore when one 
of these ROM subroutines terminates, the R-rcgister PC is examined. If it is outside the range 
177000b- 177777b, then control is passed to the beginning of tlie emulator's main loop in the 
ROM. Otherwise, control is passed to location PC AND 777b in RAM or ROML llie bank 
dispatched to is determined by die swmodk rules described in section 8.4. 

Warning: Some of these ROM subroutines modify PC during execution. If BLT or BLKS or 
BrrBLT is terminated by an interrupt condition, PC is decremented by 1 so that the instruction 
can be resumed later. If a div is successful, PC is incremented by 1 to cause a skip. 

RFGISILR CALL (uSCd with RAMCYCX) 

This call uses an R-register, in this case cyrlt (R-register 5), to dispatch into a table of successor 
instructions. The cyclic shift subroutine, for example, is called from six places in the ROM. Each 
of these places sets cyrlt to the index of its successor instruction in the return dispatch table [0- 
5], and then dispatches into the cycle table beginning at IjO. The successor corresponding to 
RAMCYCX dispatches into ram or romi using the low-order 10 bits of the PC register, according 
to the SWMODP. rules described in section 8.4. 

ir calls 

These calls use the emulator's IR register in various ways: some straightforward and some 
devious. The main advantages of IR calls are that 

1) several levels of return can be encoded into a single number, because it is fairly easy 
to dispatch on various parts of IR, and 

2) unlike R-registers, IR can be loaded in one microinstruction. 

llie most straightforward use of IR is dispatching on its low-order 8 bits using the disp bus 
source. Since IMSP is a bus source >3, a constant may be "and-ed** onto the bus with DiSP. 
allowing one to dispatch on sub-fields of DISP. 
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The most devious use of IR involves a group of constants labeled srO to srl2, srl4 to srl7, and 
sr20 to sr37 (as you might suspect, the numbers on these constant names are octal). If the 
constant sr/ has been loaded into IR, then the following code will cause control to transfer to 
location FOO OR /: 

IDISP; (see section 3.5) 

:foo; 

The statement above is only tme if / is less than 20b; otherwise an additional dispatch on the 
DiSP field of IR is required to get' the desired effect: 

F0013: SINK<-DISP, BUS; 

:FOO20; 

(This explains why there is no srl3. Any of sr20-sr37 will carry control to the 13Bth entry in 
FOO*s dispatch table, where an additional level of dispatch can be used to diffcjentiate among 
them if necessary. You may be wondering what is special about 13b. You are in good company.) 

9,2.2 The Silent Boot 

Many of the effects of a hardware "reset*' operation (invoked by the boot button. or.nus[0] = l in 
conjunction with the emulator-specific Fi s^J ARTF (17b)) can be faithfully simulated by emulated software. 
At least two important ones cannot. A reset operation is the only way of moving non-RAM-related tasks 
back ajid forth between ROMO and ramo, and the only way of guaranteeing that all tasks are initialized. 
However, the time required for a reset operation is not necessarily longer than a few microseconds. On 
both Alto Is and Alto lis a reset operation does not alter the contents of the Alto's R or s registers, its 
microinstruction ram, or its main memory. Therefore if these memories contain appropriate contents it 
is not really necessary to go through the full disk or P^thernet bootstrap load sequence, since the major 
purpose of those sequences is to initialize these memories witli desired contents. 

The "silent boot" consists first of getting the desired contents into the ram and main memory, ramo 
should contain an emulator task (beginning with address 0) which, for example, simply jumps into the 
main loop of the ROM emulator code, skipping all the bootstrap code, l^or example: 

NOViiM: SWMODF; (ramo location 0, task O's reset location,) 

:START; (to ROMO location 20b) 

Second, the reset mode register should be set so that the reset operation will begin execution of the 
emulator task in ramo, and the other tasks wherever they are desired. Rnally, the reset operation is 
initiated, the emulator hiccoughs momentarily into RAMO, and then proceeds in ROMO as if nothing had 
happened. 

9.2 J Debugging the Emulator 

As someday it may happen that a bug must be found in a new version of the emulator, microcodes 
should be aware of a nice trick. Suppose you have an Alto witli a working emulator in its ROM. and 
load the suspect emulator into the ram. Your courage leads you to execute a JMRRAM with ACl -20b 
(SIART), and hope that the new emulator behaves. But alas, the machine dives into oblivion. Now the 
trick applies: before jumping into the RAM version, plant a jmpram (with ACl -20b) somewhere in the 
Nova code that you know will be executed. Now go to the ram wiUi the horrid jmpram. If the suspect 
emulator has not died by the time it executes the jmpram you planted, control will return to the benign 
ROM. This method, together with the obvious search technique, may locate an offending emulator 
instruction. 
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9.2.4 How to (ell if extended ROM or RAM exists 

A standard convention assures that location 777b in ROMl, if it exists, contains the code: 

SWRET: SWMODE; 

:STAR'r; 

First, we store the following snatch of code in ramo, with inram located at location 777n: 

INRAM: I>AC0+1. SWMODE; 

ACO<-U :START; 

Now we store in ACQ, and use the JMPRAM emulator instruction to branch to location 777b. 'I'his will 
cause cither the swRirr or inram code to be executed; in any case, the emulator instruction following the 
JMPRAM will eventually be executed. If aco has been set to 1, ROMl does not exist; otherwise ROMl does 
exist. 

To determine whether the 3k ram option is present, use wrtram to write different values into 
corresponding locations in two different ram banks, then use rdram to read back the first location 
written. If the 3k ram option is present, the location will still contain the value written into it; if the 
option is absent, it will have been clobbered by the value intended for the second ram bank. 

9.2.5 RAM Utility Area 

It sometimes happens that a small piece of microcode must be loaded into the RAM so that tlie emulator 
can execute it by doing a JMPRAM to it; it will then return to the emulator. For example, such a piece 
of code is required in order to set the reset mode register. By convention, we reserve a uliliiy area of 
RAMO for this purpose. The normal procedure is to save the contents of this area (using RDRAM), store 
the piece of code that is to be executed (using wrtram), execute the code (using jmpram), and then 
restore the original contents. Writers of microcode should avoid placing code in the utility area that is 
not part of the emulator task, as it may be temporarily altered for these utility operations. 

^rhe normal utility area is 774b through 1003b inclusive. The alert reader will recognize that jmpram can 
successfully transfer into this area in ramo when coming from ROMO (locations 1000Ji-1003B are 
accessible) or from ROMl (locations 774b-777b are accessible). A program will therefore need to know 
where it is executing (romo or ROMl) and use an appropriate entry point to the utility area. 

9.2.6 Other Information 

Correct operation of most Alto peripherals depends vitally on their tasks receiving adequate service. This 
in turn depends on two things: 

1. A task must have sufficient priority to gain however many cycles it needs for service, at the 
expense of lower-priority tasks. The choice of priority must be made carefully when tlie 
interface is designed. 

2. Other tasks at the same and lower priorities must be well-behaved. In particular, they must 
perform task switches no further apart than the maximum latency permitted for the task in 
question. 
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It is believed that the standard Alto peripheral most sensitive to task latency is the Diablo disk controller 
when connected to a Model 44 disk drive. This is due to the fact that the data rate is relatively high and 
the controller has only 16 bits of buffering. 

It has been detennined empirically that task latency greater than 20 microinstmction times causes Diablo 
Model 44 disks to encounter data-late errors. Therefore, when writing microprograms, it is essential tliat 
you issue a task at least once every 20 microinstructions (preferably once every 15). When counting 
microinstruction times, do not forget to include the cycles during which the processor is suspended due 
to memory references. 
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APPENDIX A - MICROINSTRUCTION SUMMARY 



FII-I.DS: 



0-4 


RSELECT 


5-8 


ALUF 


9-11 


BS 


12-15 


1-1* 


16-19 


E7* 


20 


LOAD T 


21 


ID AD L & M* 


22-31 


NBXT 



*High-ordcr bit complemented by RDRAM and WRTRAM. 
All subsequent numbers on this page are in octal. 
ALUF: 



0: BUS 

1: 1^ 

2: BUS OR T* 

3: BUS AND T 


4: BUSXORT 
5: BUS+1* 
6: BUS-1* 
7: BUS+T 


10: 
11: 
12: 
13: 


BUS-T 
BUS-T-1 

BUS + T+1* 
BUS + SKIP* 


14: BUS.T* 

15: BUS AND NOT T 

16: UNDEFINED 

17: unde:i'ined 




*rx>ads T 


from ALU output 












BUS SOURCn (standard): 














0: <-RLOCATION 
1: RLOCATION*- 
2: None(BUS*-l) 
3: (task-specific) 


4: 
5: 
6: 
7: 


(task-specific) 
<-MD 
<-MOUSE 
^DISP 










Fl (standard): 
















0: - 

1: MAR- 
2: TASK 
3: BLOCK 


4: 
5: 
6: 
7: 


^L L,SH 1 
^L RSH 1 
^L LCY 8 
^CONSTANT 










r7 (standard): 
















0: - 

1: BUS-0 
2: SH<0 
3: SU = 


4: 
5: 
6: 

7: 


BUS 
ALUCY 
MD^ 
^-CONSTANT 










BUS SOURCE (task-specific): 

CPU 


4J6 7 
KSEC.KWD inilER 


RAM 

Related 








3: ^SLOCAriON ^KSTAT 

4: SLOCAl'lON^ ^KDATA EIDFCT 


^SIDCATION 
SLOCATION*- 




Fl (task-specific): 

















CPU 


4. 16 
KSEC.KWD 


7 
imiER 


11 
DWT 




12 
CURT 


13 14 
DIIT DVT 


RAM 

Related 


10: SWMODE 
11: WRfRAM 


STROBE. 


: 








- 


(SWMODE) 

Wiri'RAM 


12: RDRAM 


KSTAT*- 


- 








- 


RDRAM 


13: RMR^ 


INCRECNO 


ELECT 








- 


SRB*- 


14: - 


CLRSfAT 


EPFCr 








- 


. 


]5: FSRB^ 


KCOMM<- 


EWFCr 








- 


- 


16: RSNF 


KADR*- 


- 








, 


- 


17: SI'ARTl- 


KDATA^ 


- 








- 


- 


1-7 (task-specific); 



















4, 16 


7 


11 




12 


13 14 


RAM 


CPU 


KSEAKWD 


EJniER 


DWT 




CURT 


DIIT DVT 


Related 


JO: 15US0DD 


INIT 


EODFCT 


DDR^ 




XPREG^ 


1-:VENITELD EVENFIELD 




n: MAGIC 


RWC 


EOSFCr 


- 




CSR*- 


SETMODE 




12: DNS^ 


rf:cno 


ERBFCT 


- 






- 




13: ACDl^ST 


XIRDAT 


EEFCT 


- 






- 




14: IR*- 


SWRNRDY 


EBFCr 


- 






- 




15: IDISP 


NFI^R 


ECBPCr 


- 






- 




16: ACSOURCE 


STROBON 


EISFCT 


- 






- 




17: - 


- 


- 


. 






- 
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APPENDIX B - S lANDARD RESERVED MEMORY LOCATIONS 



All numbers are in octal. 



Ix)cation 



Name 



Page 0: 




0-17 




Page 1: 




400-412 




420 


DASTART 


421 


- 


422 


ITQUAN 


423 


liRITS 


424 


MOUSRX 


425 


MOUSHY 


426 


CURSORX 


427 


CURSORY 


430 


RIC 


431-450 


CURMAP 


452 


WW 


453 


ACTIVE 


457 


- 


460-477 


MASKTAB 


500 


PCLOC 


501-517 


IN'rVHC 


521 


KliLK 


522 


KSTAT 


523 


KADDR 


524 




525 


iniMi-: 


527 


^iRAPPC 


530-567 


IRAl^VEC 


570-577 


- 


600 


moc 


601 


¥MDC 


602 


EELOC 


603 


ELLOC 


604 


EiCEOC 


605 


laPEOC 


606 


liOCEOC 


607 


EOPLOC 


610 


EllEOC 


611-612 


- 


613 


- 


614 


DCBR 


6)5 


KNMAR 


616 


DWA 


617 


CBA 


620 


PC 


621 


SAD 


(Note: Disk an( 


1 lUlicrnct bootstrap 


700-707 


- 


Page 376B: 




1770 16-17701 7 


UriLOUT 


177020-177023 


XBUS 


J 77024 


MlvAR 


177025 


MI-SR 


177026 


MlvCR 


177030-177033 


U'llLIN 


177034-177037 


KHDAD 


Page 3771$: 




177740-177757 


PANKREGS 



Contents 



Set to 77400B by OS (Swat) 

Used by standard bootstrap operation 

Display list header (Std. Microcode) 

Display vcitical field interrupt bitword (Std. Microcode) 

Interval timer stored quantity (Std. Microcode) 

Interval timer bitword (Std. Microcode) 

Mouse X coordinate (Std. Microcode) 

Mouse Y coordinate (Std. Microcode) 

Cursor X coordinate (Std. Microcode) 

Cursor Y coordinate (Std, Microcode) 

Real Time Clock (Std. Microcode) 

Cursor bitmap (Std, Microcode) 

Interrupt wakcups waiting (Std. Microcode) 

Active mterrupt bitword (Std. Microcode) 

Zero (Extension of MASKTAB by convention; set by OS) 

Mask table for convert (Std. Microcode; set by OS) 

Saved intermpt PC (Std. Microcode) 

Interrupt Transfer Vector (Std. Microcode) 

Disk command block address (Std. Microcode) 

Disk status at start of current sector (Std. Microcode) 

Disk address of latest disk command (Std. Microcode) 

Sector intermpt l>it mask (Std. Microcode) 

Intci-val timer time (Std. Microcode) 

i'rap saved PC (Std. Microcode) 

'IVap vector (Std. Microcode) 

Timer data (OS) 

Itthcrnet post location (Std. Microcode) 

Ethernet mterrupt bit mask (Std. Microcode) 

Ethernet ending count (Std. Microcode) 

Ethernet load location (Std. Microcode) 

I:thernct input buffer count (Std. Microcode) 

Ethernet input buffer pointer (Std. Micrococfc) 

E.thcrnct output buffer count (Std. Microcode) 

Ethernet output buffer pointer (Std. Micrococle) 

E.thcrnct host address (Std. Microcode) 

Reserved for E.thernet expansion (Std. Microcode) 

Alto I/II indication that microcode can interrogate (0- Alto I, -l = Alto II) 

Posted by parity task when a main memory parity error is detected. 

" (Std. Microcode) 



Saved registers (Swai) 

Printer output (Std. Hardware) 

Utility input bus (Alto 11 Std. Hardware) 

Memory Error Address Register (Alto II Std. Hardware) 

Memory error status register (Alto II Std, Hardware) 

Memory error control register (Alto II Std. Hardware) 

Printer status, mouse, keyset (all 4 locations return same thing) 

Undecoded keyboard (Std. Hardware) 

Extended memory option bank registers - sec section 2.3 
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APPENDIX C - RESERVED SIO BITS 

Bit lOOOOOB Standard Alto: SoRware boot feature - Sec SIO, section 3.3 
Bit 14 000002B Standard Alto: Ethernet 

Bit 15 OOOOOIB Standard Alto: Ethernet 



APPENDIX D - STANDARD TASKS 



Task 


Name 


Section 


Description 





Fjnulator 


3 


I x)west priority. Wakeup always true. 


1 


- 


- 


unused 


2 


- 


- 


unused 


3 


- 


- 


unused 


4 


KSEC 


6 


Disk sector task 


5 


- 


- 


unused 


6 


- 


- 


unused 


7 


EHIER 


7 


Ethernet task 


lOB 


MRr 


- 


Memory refresh task. Wakeup every 38.08 microseconds. 


11 B 


DWV 


4 


Display word task 


:12B 


CURT 


4 


Cursor task 


13B 


DIIT 


4 


Display horizontal task 


14B 


Dvr 


4 


Display vertical task. Wakeup every 16.666 milliseconds. 


15B 


l^ART 


5.5 


Parity task. Wakeup generated by parity error. 


16B 


KWD 


6 


Disk word task 


17B 


- 


- 


unused 
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APPENDIX E 


Opcode 


Trap location 


60000-60377 


_._ 


60400-60777 


531 


61000-61377 


532 


61400-61777 


533 


62000-62377 


534 


62400-62777 


535 


63000-63377 


536 


63400-63777 


537 


64000-64377 


540 


64400-64777 


-,- 


65000-65377 


... 


65400-65777 


543 


66000-66377 


544 


66400-66777 


545 


67000-67377 


,., 


67400-67777 


547 


70000-70377 


550 


70400-70777 


551 


71000-71377 


552 


71400-71777 


553 


72000-72377 


554 


72400-72777 


555 


73000-73377 


556 


73400-73777 


557 


74000-74377 


560 


74400-74777 


561 


75000-75377 


562 


75400-75777 


563 


76000-76377 


564 


76400-76777 


565 


77000-77377 


566 


77400-77777 


567 



SGROUP INSTRUCTION SUMMARY 

Name 

CYCLE 

RAM trap 

Parameterless opcodes to 61026» ROM trap for rest 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

JSRII 

JSRIS 

RAM trap 

RAM trap 

RAM trap 

CONVERT 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

RAM trap 

ROM trap, reserved for Swat 



APPENDIX F - ALTO I / ALTO II DIFFERENCl^ 

The minor differences between Alto I and Alto II are explained in this manual. This appendix serves as 
an index of those differences: 

Memory reference timing (section 2.3) 

Certain emulator instructions (Rcrx, sio, srr. vers, dread. 

DEXCII. DJAGNOSEl. DIAGN0SE2; SCCtion 3.3) 

Keyboard layout (section 5.1) 
Hxternal device connector (section 5.4) 
Memory configuration switch (section 5.5) 
Memory parity error detection (section 5.5) 
2k ROM and 3k ram options (section 8.4) 
Kxtcnded memory option (section 2.3) 
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APPENDIX G - SUMMARY OF KNOWN FEATURES/BUGS 
IN RELEASED MlCJiOCODE VERSIONS 



Alto I version 23: 

VERS instruction: 
BITBLT instruction: 

Alto II version 2: 

VERS instruction: 
BITBLT instruction: 

RDRAM instruction: 

DEXCll instruction: 
SIT instruction: 

ACSOURCE function: 

Alto I version 24: 

No known bugs. 

Alto II version 3: 

SIT instruction: 



returns engineering number 0. microcgdc version 1. 

doesn't work reliably if some ram-related task is running 
(e.g., the Trident disk). 



returns engineering number 2, microcode version 0. 

doesn't work reliably if some ram-related task is running 
(e.g., the Trident disk). Expects L to be zeroed by the 
caller. 

does not work reliably when the Ethernet interface is 
active. 

does not work at all. 

TIMEMASK is 7700B but should be 7774b, Fails to store 

into ITQUAN. 

does not work precisely as documented. Consult 
McCreight if you really need to know. 



Fails to store into itquan. 
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APPENDIX H - PARC/SDD RESERVED MEMORY LOCATIONS 



All numbers arc in octal. 



Ivocation 



Name 



Contents 



Page 0: 




451 


Color map pointer 


456 


Mesa disaster flag 


526 


SamllTalk trap exit instruction 
Tape control block list 


622 


630-640 


Second Ethernet control block 


631-661 


Hexadecimal floating-point microcode 
1 ridcnt disk control block 


640-644 


640-651 


ITiird Ethernet control block 


720-777 


SLOT devices 


776-777 


Music 


Page 376B: 




177100 


Summagraphies tablet X 


177101 


Summagraphics tablet Y 
Organ keyboard 


177140-177157 


177200-177204 


PROM programmer 


177234-177237 


Experimental cursor control 


177240-177257 


Alto II debugger 
Graphics keyboard 


177244-177247 


Page 377B: 




177400-177405 


Maxc2 maintenance interface 


177400 


Alto DLS input 


177420 


" 


177440 


" 


177460 


" 


177600-177677 


Alto DLS output 


177700 


ElA interface output bit 


177701 


BIALOC ElA interface input bit 


177720-177737 


TV Camera Interface 


177764-177773 


Redactron tape drive 


177776 


Digital-Analog Converter 


177776 


Digital-Analog Converter, Joystick 


177777 


Digital-Analog Converter, Joystick 



APPENDIX I - PARC/SDD RESERVED SIO (STARIF) BITS 



Bit 1 


040000B 


Maxc2 Memory Interface 


Hit 2 


020000B 


Maxc2 Memory Interface 


Bit 3 


OlOOOOB 


Maxc2 Memory Interface 


Bit 4 


004000B 


Aurora 


Bit 5 


002000B 


Arpanet Interface 


Bit 6 


OOIOOOB 


Arpanet Interface 


Bit 8 


000200B 


Tape controller 


Bit 9 


OOOIOOB 


available 


Bit JO 


0000401^ 


Trident disk interface 


Bit 11 


000020B 


Trident disk interface 


Bit 12 


OOOOIOB 


available 


Bit 13 


000004B 


Printer interfaces (Orbit, Slot) 



Bits 10-11 Second Ethernet interface 
Bits 12-13 'lliird Ethernet interface 



APPENDIX J - PARC/SDD TASKS 



Devices 



Tasks 



Trident Disk Controller 

Orbit 

Slot 

Tape Controller 

Audio 

Aurora 

Maxc2 Memory Interface 



3 and 17B 

1 

1 

5 and 6 

? 

? 

i7n 
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APPENDIX K - OPTIONAL ALTO PERIPHERAI^ 

lliis appendix lists hardware items that have been interfaced to the Alto in quantities greater than one. 
i:OD/SPG is the source for information about many of these interfaces and devices, and may be willing to 
contract to provide necessary hardware. Sources in PARC are not committed to producing any hardware. 
No software guarantees are made about any of these devices, except as noted. 

HyType Printer. A spinning daisy printer can be ordered from Diablo Systems, Inc. 
Arrangements can be made with SPG to build a cable that will connect the printer to 
the "printer connector" on tlae rear of the Alto. No additonal hardware is required, 
although printers attached to Alto II are required to be self-powered. Software: 
Bravo prints on the Diablo printer, and a Bcpl subroutine package (DiabloPrinter.lk) 
is available to drive the interface. 

Versatec Printer/Plotter. The Versatec plotters and printer/plotters can be connected 
to the Alto II without additional hardware. Contact SPG to get a cable (P/N 216540). 

Tape Controller. A two-card processor-bus interface to MDS and Kennedy tape 
drives. It will handle 1600 bpi phase-encoded tapes only. Contact ASD-South. 

Trident Disk Interface. An interface to the Trident family of disk drives, 
manufactured by Calcomp. Alto II owners should contact SPG, Alto I owners contact 
PARC/CSI.. Software: The Trident disks may be accessed in conjunction with 
Operating-System routines, using the tfs software package (see Alto Subsystems 
documentation). 

Orbit. A piece of hardware which can be used to drive a variety of SLXDT printers 
that obey the "9-wirc standard ROS interface." Contact ASD-South. 

Extra Ethernets. Up to two extra Ethenets can be installed in ah Alto of any vintage. 
Contact PARC/CSL. 

Ethernet Repeaters. Many miles of Ethernet can be hooked together with these. 

Contact PARC/CSL. 

ArpaNet (BBN 1822) Interface. An interface to ArpaNet Imps and Packet Radio Units. 
Contact PARC/SSL. 

EIA Interface. An interface to an ami S1883 uart and an ami S2350 usrt. Contact 
ASO-Soutli. 

Communications Processor. Terminates up to 16 lines at many speeds, codes and \\flc 
control disciplines. Contact ASD~South. 



